home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir38 / grabb397.zip / DOCFILES.SFX / GR4AI.DOC < prev    next >
Text File  |  1994-05-14  |  20KB  |  402 lines
  1.  
  2.  
  3.                                     GRABBER/AI(tm)
  4.                            8514/A Adapter Interface Version
  5.  
  6.                             Release 2.00S  Shareware Issue
  7.                            --------------------------------
  8.  
  9.                               The Screen Capture Program
  10.                            for MS-DOS and 8514/A-Compatible
  11.                                     Video Graphics
  12.  
  13.  
  14.                           DOCUMENTATION AND TECHNICAL NOTES
  15.                                      May 14, 1994
  16.  
  17.                                 Copyright 1987-1994 by
  18.                                    Gerald A. Monroe
  19.                                  All rights reserved.
  20.  
  21.  
  22.                  +-------------------------------------------------+
  23.                  |  Although they are shareware, GR4AI and this    |
  24.                  |  documentation file are copyrighted.  They are  |
  25.                  |  not in the  public  domain  and they are  not  |
  26.                  |  "freeware."   Please  consult  page 6  of the  |
  27.                  |  REGISTER.DOC  file  for  important  copyright  |
  28.                  |  information and license provisions.            |
  29.                  +-------------------------------------------------+
  30.  
  31.  
  32.                Thank you  for your interest in  the GRABBER(tm) screen
  33.                capture system!
  34.  
  35.                The GRABBER  package is being marketed  in this special
  36.                form as shareware.  This means you have the opportunity
  37.                to  use and evaluate it  for 30 days  before you decide
  38.                whether  to buy.   If  you  continue to  use GRPCX.EXE,
  39.                GRABBER.EXE, any of its "offspring" programs, or any of
  40.                the other  programs in the GRABBER  package beyond such
  41.                30-day  period,  then you  are  required  to send  your
  42.                registration  fee to  the  publisher according  to  the
  43.                instructions in the REGISTER.DOC file.  When you regis-
  44.                ter, you will receive  a copy of the latest  release of
  45.                the registered GRABBER package that you order.  You may
  46.                not continue  using GRABBER  beyond such 30-day  period
  47.                without registering.  For registration instructions and
  48.                a complete statement  of your license to use this soft-
  49.                ware, please consult the REGISTER.DOC file.
  50.  
  51.                               Gerald A. Monroe
  52.                               P.O. Box 770906
  53.                               Cleveland, Ohio 44107, U.S.A.
  54.                               CompuServe Mail:  72321,1257
  55.                               Fax:  (216) 521-6060
  56.  
  57.           IBM  and PC  are  trademarks of  International Business  Machines
  58.           Corporation.   MS-DOS  and  Windows are  trademarks of  Microsoft
  59.           Corporation.
  60.  
  61.                                   Table of Contents
  62.  
  63.  
  64.                Shareware Registration and License Information .....  1
  65.  
  66.                Overview of GR4AI.EXE ..............................  3
  67.  
  68.                About this documentation ...........................  4
  69.  
  70.                Using GRABBER and GR4AI simultaneously .............  4
  71.  
  72.                Modifying the GR4AI hotkey .........................  4
  73.  
  74.                GR4AI's audible error indicators ...................  5
  75.  
  76.                GR4AI installation options, including the following:
  77.                  *  DEFAULTDRIVE
  78.                  *  MOUSE and NOMOUSE
  79.                  *  UNLOAD
  80.                  *  SOUND and NOSOUND
  81.                  *  PROMPT and NOPROMPT
  82.                  *  NOSWAP
  83.                  *  NOEMS
  84.                  *  NOUMB
  85.                  *  INT=nn
  86.                  *  INT=OFF
  87.                  *  BATCHCAPTURE
  88.                  *  BATCHCAPTURE:filename .........................  5
  89.  
  90.                Offspring file compatibility with other systems ....  6
  91.  
  92.                Offspring file command-line options ................  6
  93.  
  94.                Converting GR4AI offspring to PCX and GIF formats ..  7
  95.  
  96.                Calling GR4AI from your own programs ...............  8
  97.  
  98.           GR4AI(tm)        Documentation & Technical Notes      Page 3 of 8
  99.  
  100.  
  101.  
  102.           OVERVIEW OF GR4AI.EXE
  103.           ----------------------
  104.  
  105.           GR4AI(tm) is an alternative version of the GRABBER screen capture
  106.           program.   It is designed exclusively  for capturing high-resolu-
  107.           tion 640 x 480 and 1024 x 768 graphic images from PC systems that
  108.           are compatible with  the IBM 8514/A Adapter  Interface, and which
  109.           are running in "real mode" under MS-DOS.  (GR4AI does not capture
  110.           screens from Microsoft Windows or Windows applications.)
  111.  
  112.           The Adapter Interface,  or "AI," is a  programming interface that
  113.           lets application  programs work  with your high-resolution  video
  114.           adapter.   Usually, the AI  is loaded as  a memory-resident (TSR)
  115.           program in your computer's memory.  When it is present, it allows
  116.           GR4AI to capture certain types of high-resolution graphics.
  117.  
  118.           GR4AI can only capture a screen if the foreground program that is
  119.           generating the image  is actually using the  AI to do  its screen
  120.           work.  Note that  this is not always  the case.  For  example, if
  121.           you have  an IBM 8514/A  adapter, or another  manufacturer's card
  122.           that  is compatible with IBM's 8514/A at the register level (such
  123.           as  an ATI 8514/Ultra, Graphics Ultra  or Graphics Vantage card),
  124.           then  it is possible for  some application programs  to work with
  125.           the  screen by writing directly  to the adapter's hardware regis-
  126.           ters  and ignoring the AI  completely.  GR4AI  cannot capture any
  127.           screens  from such applications,  because unless the  AI is being
  128.           used  for screen  output, GR4AI has  no way  of knowing  that the
  129.           adapter is in use at all.
  130.  
  131.           Therefore,  if you  have an  application from  which you  want to
  132.           capture  screens,  and the  application's  installation or  setup
  133.           allows you  to choose between AI-compatible  and 8514/A register-
  134.           level compatible video, then  you should choose the AI-compatible
  135.           option.
  136.  
  137.           Whatever kind of  video hardware is  installed, GR4AI expects  to
  138.           find an AI driver resident in memory when you ask it to capture a
  139.           screen.  If an AI  driver is not present, GR4AI will  not capture
  140.           the  screen.  (With the IBM 8514/A and the ATI 8514/A-compatibles
  141.           mentioned above, the  AI driver  is called HDILOAD.EXE.   If  you
  142.           have a different brand of adapter,  the driver file may be called
  143.           by a different name.)
  144.  
  145.           Note that  you do not have  to have an adapter  that is register-
  146.           level compatible with the 8514/A in order to use GR4AI.   All you
  147.           need is an adapter that comes  supplied with an AI driver, and an
  148.           application program that uses the AI for its screen output.
  149.  
  150.           GR4AI(tm)        Documentation & Technical Notes      Page 4 of 8
  151.  
  152.  
  153.  
  154.           ABOUT THIS DOCUMENTATION
  155.           -------------------------
  156.  
  157.           GR4AI  can be installed  in memory and operated  in much the same
  158.           way as GRABBER.EXE, and the two programs have a very similar look
  159.           and feel.  For the most part, this documentation for GR4AI covers
  160.           only the aspects  of GR4AI which differ from GRABBER.EXE.  To use
  161.           GR4AI effectively, you should read the GRABBER program documenta-
  162.           tion and become familiar with GRABBER's operation.
  163.  
  164.  
  165.  
  166.           USING GRABBER and GR4AI SIMULTANEOUSLY
  167.           ---------------------------------------
  168.  
  169.           GR4AI is designed to  be compatible with GRABBER.   Both programs
  170.           can be installed in memory and used at the same time, but only if
  171.           you specify the "INT=OFF"  command-line switch when you initially
  172.           load GR4AI.EXE in memory.
  173.  
  174.           The default "hotkey" sequence for GR4AI is [Ctrl Alt  F10].  That
  175.           is,  you hold down the [Ctrl]  key and the [Alt]  key at the same
  176.           time, then press the [F10] key, then release all three keys.
  177.  
  178.           As  in GRABBER, the MOUSE command-line option in GR4AI allows you
  179.           to  capture the screen  by holding down the  left and right mouse
  180.           buttons  simultaneously  for one  or two  seconds.   If  you have
  181.           installed both GRABBER.EXE and  GR4AI.EXE in memory simultaneous-
  182.           ly, you  should not  use the  MOUSE switch  to  enable the  mouse
  183.           hotkey with both programs.  Strange results are almost guaranteed
  184.           to occur, and  it may even lock up your computer when you use the
  185.           mouse hotkey.   It is  acceptable to  use the  MOUSE switch  with
  186.           either GR4AI or GRABBER, but not both.
  187.  
  188.  
  189.  
  190.           MODIFYING THE GR4AI HOTKEY
  191.           ---------------------------
  192.  
  193.           GR4AI  allows you to modify your hotkey sequence from the default
  194.           [Ctrl  Alt F10] to practically any other key sequence you choose.
  195.           In this respect,  GR4AI is  exactly like  GRABBER.   There is  no
  196.           separate  documentation  here  which  covers  the  procedure  for
  197.           changing your GR4AI  hotkey.   GR4AI uses the  exact same  hotkey
  198.           procedures  as GRABBER.   You can  read about these  in the GRAB-
  199.           BER.DOC manual, at page 33 and at Appendices A and B.  (To view a
  200.           list of valid KEY= codes for  GR4AI, use the command GR4AI KEY=?.
  201.           To view a list of valid SHIFT= codes, enter GR4AI SHIFT=?.)
  202.  
  203.           GR4AI(tm)        Documentation & Technical Notes      Page 5 of 8
  204.  
  205.  
  206.  
  207.           GR4AI's AUDIBLE ERROR INDICATORS
  208.           ---------------------------------
  209.  
  210.           If you  press  GR4AI's hotkey  and hear  one or  two short,  low-
  211.           pitched tones from your PC speaker, it means that GR4AI is unable
  212.           to capture the screen because an error condition exists.
  213.  
  214.           One  low-pitched tone indicates  that no  AI driver  is currently
  215.           loaded in memory.
  216.  
  217.           Two low-pitched tones  indicate that  an AI driver  is loaded  in
  218.           memory,  but that  it is  not presently  in  use by  a foreground
  219.           application,  or that  the  adapter is  presently operating  in a
  220.           video mode that exceeds  GR4AI's capabilities.  GR4AI is  able to
  221.           capture these AI modes:
  222.  
  223.                *  640 x 480, 16 colors       *  640 x 480, 256 colors
  224.                *  1024 x 768, 16 colors      *  1024 x 768, 256 colors
  225.                *  1280 x 1024, 16 colors     *  1280 x 1024, 256 colors
  226.  
  227.           (Three low-pitched  tones indicate  a probable disk  error during
  228.           the screen  capture  process.    See "Errors  During  the  Screen
  229.           Capture" in the GRABBER program documentation.)
  230.  
  231.  
  232.  
  233.           GR4AI INSTALLATION OPTIONS
  234.           ---------------------------
  235.  
  236.           GR4AI accepts the  following command-line configuration  options.
  237.           Each of these optional switches can be added to the GR4AI command
  238.           line to  alter GR4AI's default  mode of operation.   All of these
  239.           switches are also  available in the GRABBER.EXE program, and none
  240.           is separately  described here.   For complete  details concerning
  241.           the  purpose  of these  options and  how  they work,  consult the
  242.           section "Grabber  Installation Options"  beginning on page  14 in
  243.           the GRABBER program documentation.
  244.  
  245.                *  DEFAULTDRIVE          (specifies capture destination)
  246.                *  MOUSE and NOMOUSE     (enables/disables mouse hotkey)
  247.                *  UNLOAD                (removes GR4AI from memory)
  248.                *  SOUND and NOSOUND     (enables/disables sounds)
  249.                *  PROMPT and NOPROMPT   (enables/disables screen prompts)
  250.                *  NOSWAP                (disables swapping of DOS kernel)
  251.                *  NOEMS                 (disables GR4AI's EMS memory usage)
  252.                *  NOUMB                 (disables GR4AI'S UMB memory usage)
  253.                *  INT=nn                (specifies block of interrupt
  254.                                          vectors for redirecting IRQ0-IRQ7)
  255.                *  INT=OFF               (disables redirection of IRQ0-IRQ7)
  256.                *  BATCHCAPTURE          (causes immediate screen capture)
  257.                *  BATCHCAPTURE:filename (causes immediate screen capture to
  258.                                          file specified as "filename")
  259.  
  260.           GR4AI(tm)        Documentation & Technical Notes      Page 6 of 8
  261.  
  262.  
  263.  
  264.           OFFSPRING FILE COMPATIBILITY WITH OTHER SYSTEMS
  265.           ------------------------------------------------
  266.  
  267.           As mentioned above  on page  4, GR4AI can  capture six  different
  268.           types of images from AI-compatible video adapters.  The six types
  269.           are:
  270.  
  271.                *  640 x 480, 16 colors       *  640 x 480, 256 colors
  272.                *  1024 x 768, 16 colors      *  1024 x 768, 256 colors
  273.                *  1280 x 1024, 16 colors     *  1280 x 1024, 256 colors
  274.  
  275.           Each type  of image can be  displayed on a  different system than
  276.           the one from which it was originally captured, if the destination
  277.           system  has an  AI driver  (such as  IBM's or  ATI's HDILOAD.EXE)
  278.           resident in memory  (and assuming that the destination system has
  279.           enough  video  memory and  a monitor  that  is capable  enough to
  280.           display the particular graphics mode).
  281.  
  282.           In addition,  each type  of image  can be  displayed on  a system
  283.           which is compatible with  the VESA video BIOS extension,  even if
  284.           no  AI driver is loaded (and assuming that the destination system
  285.           has enough video  memory and a monitor that  is capable enough to
  286.           display the particular graphics mode).
  287.  
  288.           A 16-color, 640  x 480 offspring image can be  ported to any VGA-
  289.           compatible  system -- even  one which does not  have an AI driver
  290.           loaded and is not VESA-compatible.
  291.  
  292.           Some types of screens have special video memory requirements:
  293.  
  294.           *  1280 x 1024 x 256 images require at least 2 Mb of video memory
  295.           *  1280 x 1024 x 16 images require at least 1 Mb of video memory
  296.           *  1024 x 768 x 256 images require at least 1 Mb of video memory
  297.           *  1024 x 768 x 16 images require at least 512 Kb of video memory
  298.           *  640 x 480 x 256 images require at least 512 Kb of video memory
  299.  
  300.  
  301.  
  302.           OFFSPRING FILE COMMAND-LINE OPTIONS
  303.           ------------------------------------
  304.  
  305.           GR4AI offspring  files support  the same command-line  options as
  306.           are supported by GRABBER.EXE offspring  files.  This includes the
  307.           "FADEIN" and "FADEOUT" options, the  /Tn option for timed  execu-
  308.           tion, the  /F and /N options for exiting without erasing, and the
  309.           /K  keylist option.  Each of these  options is fully explained in
  310.           the GRABBER program documentation, starting at page 22.
  311.  
  312.           However, you should  note that  for technical reasons  it is  not
  313.           always  safe to use the /F and /N command-line options with GR4AI
  314.           offspring files.  These two options can cause a system crash when
  315.           you are executing a GR4AI offspring at the DOS prompt or within a
  316.           batch file,  and should not be used in those situations.  You may
  317.  
  318.           GR4AI(tm)        Documentation & Technical Notes      Page 7 of 8
  319.  
  320.  
  321.  
  322.           use  these two  options  when executing  a  GR4AI offspring  from
  323.           inside another program by  way of a SHELL or  EXEC-type function,
  324.           but  only if the parent  program re-initializes the  AI (with the
  325.           AI's HINIT or HSYNC functions) or closes the  AI (with the HCLOSE
  326.           function) immediately upon return from the child program.
  327.  
  328.  
  329.           CONVERTING GR4AI OFFSPRING TO .PCX and .GIF
  330.           --------------------------------------------
  331.  
  332.           GR4AI  is  supplied  along  with two  companion  utilities  which
  333.           convert captured AI screens to the PCX and GIF file formats.  The
  334.           utilities  are called  GRAI2PCX  and GRAI2GIF.   These  utilities
  335.           function in  exactly the same way  as the GR2PCX and  GR2GIF pro-
  336.           grams  which are also included in this GRABBER package.  However,
  337.           here  is the difference:   GRAI2PCX and GRAI2GIF  are designed to
  338.           convert only offspring screens created by GR4AI.EXE, while GR2PCX
  339.           and  GR2GIF are  designed  to  convert  only screens  created  by
  340.           GRABBER.EXE.
  341.  
  342.           For  instructions on  using  GRAI2PCX and  GRAI2GIF, consult  the
  343.           CONVERT.DOC documentation file.
  344.  
  345.           GR4AI(tm)        Documentation & Technical Notes      Page 8 of 8
  346.  
  347.  
  348.  
  349.           PROGRAMMERS NOTE:
  350.           CALLING GR4AI FROM YOUR OWN PROGRAMS
  351.           -------------------------------------
  352.  
  353.           If you are  a programmer  developing your own  software, you  can
  354.           invoke  GR4AI to capture the screen from within your own program,
  355.           assuming that GR4AI is already resident in memory.
  356.  
  357.           This is accomplished by  using GR4AI's external programming hook,
  358.           which  is really  a customized  call to Interrupt  16h, described
  359.           below.  You can write  a routine to implement this hook  in 80x86
  360.           assembly language or in any high-level programming language which
  361.           supports BIOS-level interrupt calls.
  362.  
  363.  
  364.           CUSTOMIZED INTERRUPT 16H TO INVOKE GR4AI, SERVICE 4741H
  365.           --------------------------------------------------------
  366.  
  367.           On entry:   AX = 4741h
  368.                          DL = 0    (to check only if GR4AI is resident)
  369.                          DL = 1    (to capture the current screen)
  370.  
  371.           On return:  AX = 4147h   (if GR4AI is installed in memory)
  372.  
  373.                     For DL=0
  374.                      or DL=1:   BL contains the logical drive to which
  375.                                 the capture would be attempted (DL=0)
  376.                                 or was attempted (DL=1).  0=default drive,
  377.                                 1=drive A, 2=drive B, and so forth.
  378.  
  379.                     For DL=1:
  380.  
  381.                        No -->   Capture successful.  ES:DX points to
  382.                     Carry       an ASCIIZ string which contains the
  383.                      Flag       [drive:][\path\]filename of the newly
  384.                                 created offspring (drive also coded in BL).
  385.  
  386.                     Carry -->   If DX = FFFFh, then a capture attempt
  387.                      Flag       failed due to a critical disk error or
  388.                       Set       disk-full error on the logical drive
  389.                                 encoded in BL.  (Speaker beeped in either
  390.                                 case.)
  391.  
  392.                                 If DX does not equal FFFFh, capture was
  393.                                 not attempted.  GR4AI was busy servicing
  394.                                 a prior capture request, or some other disk
  395.                                 I/O was occurring, or DOS was not in a re-
  396.                                 enterable state.  Try again momentarily.
  397.  
  398.  
  399.  
  400.  
  401.                           * * *    End of GR4AI.DOC   * * *
  402.